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PROGRAM DESIGN SPECIFICATION FOR 
THE TEST CONTROL PROGRAM (JTCPZ) ~ 
A SUB-PROGRAM OF THE JOVIAL INTERPRETER SYSTEM 

INTRODUCTION 

The Test Control Program (hoya^nof-t-a-,, ,,«<•„ 1 + - _ -m,,-.^^ 

the operation of the three general functions of the JOVIAL Interpreter System: 

1) Assembly of "Master" Communication Pool: 

2) Assembly of the system programs onto a system master taoe: 
3; Interpretation of JOVIAL-coded programs. * 

During any particular test run (which may consist of the testing of several 
operational programs) the first two general functions, if requested through 
the proper control card, are performed only once, prior to the testing of 
Uri^ °P er f lonal Pf°gram. A running log is written both on- and off-line 
SSS- ?f? ° peration > bleating: (a) the system sub-program currently 
operating, (b) any error which might cause the particular test to be terminated 
(e) the conclusion of the particular test, and (d) the conclusion of the en5re' 
test run and the disposition of the system tapes. Control of the system's 
operation is exercised by JTCPZ through its functions of reading inS core from 

oreL?f^ SyStera 5uh -l r0grm (al ° ng With its related data environment in the 
predefined sequence of operation, transfer of control to it, and subsequent 

of C itf opIrS! C ° ntr01 ^ the partlCUlar SyStem «*^£ ion^letion 

,*__.,_ • .^ sea * uence of operation of the functions is controlled bv T M +. ; rw™i 
7' UB ^ Lne car ? reader. One control card is required to effect the operation* """ 
of each general function as outlined above; each card contains the code I optics 
peculiar to that function. The absence of'any of these control cards would create 

t^^lTlTfl^l^VT^ dUping ^ t6St rm » i ' e - either - both IT 
t.ne iirst two functions listed above may be bypassed. 

Although the control cards are always read in via the card reader thP 
programs to be tested may be either on cards or prestored taoe? Tsensf switch 
is set on the console to indicate the source of input, and JTCPZ, through Se 

E bv'jlLlzr* 1011 - ^^ ^ ID Capd ' 6ither P ° kti0ns the'tape (£ be 
read xn by JALLZ), or indicates the card reader as source of input. 
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ENVIRONMENT 



Sense Indicator 

If an error is detected in the JOVIAL-coded program during processing by JALLZ, 
the latter sets Sense Indicator Bit Twelve and transfers control back to JTCPZ. 
A message is written indicating the presence of an error, and the particular 
test is terminated. 

Communication Registers 

TSSI: This is a register in "permanent core" which is utilized for storage of 
the Sense Indicator register during the operation of the First Pass of the 
Interpreter (JALLZ) and the Second Pass of the Interpreter (JOLLZ). The 
Sense Indicator register is stored here prior to the operation of the above 
programs, and then restored after the program's operation. 
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INPUTS 



Sense Switches on Console 

A test run will be made either from cards (in the card reader) or from prestored 
tape. No one run will incorporate both of these input media. When a test run is 
on cards, Sense Switch One on the console will be set to On (depressed). When the 
tests are on prestored tape, the Sense Switch will be Off, or in its normal position. 

Tapes 

There are two tapes that serve as input to JTCPZ: the master tape, which contains 
the system sub-programs, and a buffer tape containing table input for JOLLZ. A 
SEARCH sub-routine is employed by JTCPZ to locate a particular program on the 
master tapej and, dependent upon the parameter set for SEARCH, the program is 
either read into core, or the tape is positioned to the identification record of 
the program (see JMSTZ for description of program identification record). The 
Master Communication Pool is read into core by JTCPZ after the SEARCH sub-routine 
positions the master tape. 

Five tables of environmental data are written on a buffer tape by JALLZ. These 
tables are read into core by SEARCH prior to operation of JOLLZ. 

Cards 

Card input to JTCPZ consists of a series of control cards which define certain 
parameters and conditions of operation for a particular test. Although the TEST ID 
Card may be prestored (this occurs whenever the JOVIAL-coded programs are on pre- 
stored tape), all other control cards for the run are read in via the card reader. 
All control cards are based on six-character, left- justified BCD fields, and each 
card is punched starting in column one. All common information (i.e., the identi- 
fication of each type of card) must be punched exactly as illustrated' in Diagram^! 
bince a test will be discontinued when a mispunch in the identification is encountered 
it is imperative that care be exercised in the punching of the control cards. 



FN-LO-200 
1 February I960 
Page 6 



The control cards will be read in the following order: 



DATE CARD 


\ 




AMC CONTROL 






MST CONTROL 








TEST CONTROL 








TEST ID 










ENDTST 




-v 






TEST CONTROL 


-^ 






TEST ID 




-v 






ENDTST 





Date Card 

The first card in the reader should be a date card. It contains "DATE" in 
columns 1 through h, and the month, day, and year in columns 7 through 12. The 
absence of this card in any test run will merely generate "NO DATE" to be printed 
in the output heading of each testj its presence is not imperative to the suc- 
cessful operation of the system. 

Assemble Master Compool Control Card 

Only one Assemble Master Compool control card may be used per test run, and the 
request may not exceed three Compool assemblies. 



Columns l-£ - JAMCZ 



\ 



Ident of first Compool 
Ident of second Compool 



Columns 7-12 

Columns 13-18 

Columns 19-2U - Ident of third Compool 

Column 25 



Blank for Assemble Mode 

1-7 refers to which Compools, if any, have revisions 

in the card reader for the Reassemble Modes. 

1 - card revisions to first Compool 

2 - card revisions to second Compool 

3 - card revisions to first and second Compools 
U - card revisions to third Compool 

5 - card revisions to first and third Compools 

6 - card revisions to second and third Compools 

7 - card revisions to all three Compools 
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System Tape Loading Progr am Control Card 

tfbfloS^ ° f T + thiS -,^ d ind i cates t0 JTCPZ that a new system master tape is 
Compool request" * ^ fre ^ ent1 ^ in conjunction with an Assemble Master 

Columns 1-3 - MST, Identifies this as an AMC Control Card 
Columns U-6 - Identification code to be placed in output tape(s) 

The following fields are punched if oth^r than t^e -r*P*~>4. .,_,-4._ , hmm , . . 
(See Program Specification for JMSTZ.) ? ™ are desirecl - 

Columns 7-12 - Binary Input Tape A-l 
Columns 13-18 - Binary Input Tape A-l* 
Columns 19-21; - Binary Input Tape A-3 
Columns 2^-30 - Binary Output Tape B-3 
Columns 31-36 - Binary Output Tape C-3 
Columns 37-^2 - Binary Output Tape D-3 
Column k3 - Number of Output Tapes = 3 
Test Control Card 

^Vkz?sx 5 in %sZ: card " hioh speoifies »°~ '— *» —■«* 

Columns 1-6 - Program Identification - the unique identification 

assigned by the programmer to his JOVTAL-coded program. 

Columns 7-10 - TEST - card identification for recognition by JTCPZ. 

Columns 13-18 - Test Number - a sequential numbering system used to 
identify the tests for this program. 

Columns 19-21, - Compool Identification - the identification of the Compool 
to be used with this particular pro:-:, -am . 

Columns 2^-28 - FULL or blank - type of tracing mode reouested- 
automatic tr£ ce mode if blank. 

Columns 31-36 - STAREV or blank - denotes any card revisions to table 
simulation input data. 

Columns 37-1*2 - POLRSV or blank - denotes any card revisions to the program 
to be tested. s 
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Test ID Card 



This card initiates each test, and will be prestored if the test run is to 
be made entirely from tape. This card is the first card of the test deck, 
not the revision deck. 

Columns 1-6 - Program Identification - the same as appears in 

columns 1-6 of the Test Control Card; if these two 
ID'S do not exactly match, the test will be terminated 
on an error condition. 

Columns 7-12 - TESTID - card identification for recognition by JTCPZ. 



Columns 13-60 - 



Comments by programmer - any comments which the programmer 
desires as an output heading, with the restriction that 
the programmer's name appear first: the comments will be 
printed exactly as written, thus necessitating the 
inclusion of all spacing. 



End-of-Test Card 



Columns 1-6 



ENDTST - The "end-of-test" card is the last card of 
any particular test. It signifies to JTCPZ that this 
test has been completed. 



CONTROL CARD FORMATS FOR JTCPZ INPUT 



-AP&--J; 1-6 



7-/2 



13- 18 



CARD DATE \MCDAYR I 



19-24 



2 5-30 



31-31: 



37-42 



43-48 



AMC JAMCZ 



"CMPCCL \ CCMPCCL 
ID I I ID 2 



INPUT 



/.- r\\ X j iAhE 



i 7E/ .FFCGRAM' 
CONTROL' I DENT i 7E5 7 



7£:-7 ; PROGRAM 
lb ID PUT 



[END OF 
TE^T : 
CAflD j ENDTF-T 



TES TID 



TEST 
NO. 



Cr-MPOOL 
ID 3 



INPUT 



I 



Revisions] 



49-54 



60 



TAPE TAPE 

I 



COMPOOL 
ID 



Prog rammer 



OUTPUT OUTPUT 
TAPE 
2 



FULL 

c r 

BLANK 



COT PUT 
TAPE X 
3 



STAREV ; POLREV 



or 



cr 



BLANK BLANK 



s name \and comments— - 
\ 




It cf 

OUTPUT 

TAPES 



£ 



CD »=i 

Pi It" 
° K ? 

VOM IV) 
O 
M O 
VO 
On 
O 
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FUNCTIONS 
General 

1. Monitors the operation of JAMCZ; 

2. Monitors the operation of JMSTZj 

3. Operates the parameter tests of JOVIAL-coded operating programs. 

Card Reading, Tape Handling, and Printing 

1. Date Card - if this card is in the reader, the date is stored for printing) 
if not, "NO DATE" is stored, and a test is made to determine what control 
card was read. 

2. Reads control cards from the card reader. 

3. Searches for a given test: 

a. If the test run is on tape, the tape is positioned on the basis 
of the program identification in the Test Control Card; 

b. If the test run is all on cards, the program identification in 
the Test Control Card is matched with that in the TEST ID Card. 

U. Searches and reads in from the master tape any Corapool or program 
required in the operation of a test. 

5. Prints a running log of the system operation during each test 
indicating successful completion or reason for termination. 

6. Sets up page heading for each test and prints it on the off-line 
printer. The heading includes: 

a. Program ID 

b. Test number 

c. Comments from TEST ID Card (programmer's name, etc.) 

d. Compool ID 

e. Master tape ID 

f . Date of test 

7. Rewinds system tapes at the end of each test run. 

8. On the termination of a test due to an error, those cards associated 
with the test in question are read over, and a new test is initiated. 
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JTCPZ/JAMCZ 



1. Heads Assemble Master Communication Pool Control Card. 

2. Heads in JAMCZ program from master tape and transfers control to it. 

3. Checks error indicator set by JAMCZ and sets it for subsequent 
JMSTZ operation. " ' " " H " 

JTCPZ/JMSTZ 

1. Reads JMSTZ Control Card. 

2. Communicates status of JAMCZ error indicator to JMSTZ, 

3. Reads in JMSTZ program from master tape and transfers control to it. 

TCP/Test Control 

1. Reads Test Control Card and sets required parameters for the ensuing 
test. 

2. Reads Test ID Card from either the card reader or pre stored tape and 
compares the two program iJJ's; on an equal condition the test is 
inaugurated; on a mismatch the test is terminated and the next Test 
Control Card is read. 

3. Terminates a particular test if the Test Control Card is missing. 

Iu Initiates the operating path of the system by reading in, and trans- 
ferring control to, the system sub-programs in their predefined 
sequence of operation: 

Set indicators for: 

a. revisions to JOVIAL-coded program in the card reader; 

b. revisions to the Table Simulation Data in the card reader. 

Read in Master Communication Pool; 

Read in and transfer control to JALLZ; 

Test error indicator upon completion of operation of JALLZ, and 

terminate test if an error was located in the JOVIAL-coded program* 
Read in and transfer control to JABCZj ° ' 

Read in and transfer control to JSTRZ; 

Read in five environmental tables, created by JALLZ, for operation of JOLLZ: 
Read in and transfer control to JOLLZ; 
Read in and transfer control to JDSYZ; 
Read in and check card from reader for ENDTST card; 
Initiate new test on presence of Test Control Card in card reader. 
If end of test, print message signifying this and rewind system tapes. 
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OUTPUTS 



Sense Indicator 

There are two sense bits set by JTCPZ, contingent upon the status of revisions: 

Sense Bit Six is set when there are revisions to the JOVIAL-coded program 
in the card reader; and 

Sense Bit Eight is set when there are revisions to the input data of J3TRZ 
in the card reader. 

Communication Registers 

DATE, DATE+1: There are two consecutive registers in "permanent core" which 
contain the date of the test run. The month, day, and year (separated by the 
conventional slash marks) are stored, right-oriented, in these two registers 
for printout on the first page of each test's results. The 'date is also 
printed on the heading page for the Master Compool Program. 

TRAP1, TRAP2: These are two registers in "permanent core" which are set to 
indicate the type of tracing mode to be utilized by JOLLZ and JDSYZ. They 
are set as follows (from information on the Test Control Card): 

TRAP1 = 0, TRAP2 t - Automatic trace mode; 
TRAP1 / 0, TRAP2 f - Full trace mode. 
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MESSAGE PRINTOUTS 



One of the functions of JTCPZ is the on- and off-line printout of a 
log of the system operation and of any error which would effect the termination 
of a particular test prior to its normal completion. Following is a descriptive 
list of all messages generated by JTCPZ: 

1. NO DATE 

This indicates the omission of a date card in the card reader, and 

is Drinted from CommurH na+.-i nr\ T-oo-ia+oT-o nATiTT «~j -n/imTP.n 

2. ASSEMBLE MASTER COMPOOL 

Printed on the first line of the Master Compool output for identification 
of program operation. 

3. SYSTEM TAPE LOADING PROGRAM 

Printed on the first line of the JMSTZ output for identification of 
program operation. 

k. ERROR IN CARD, IMAGE BELOW 

If a JTCPZ input card was not of the proper format, this message is 
printed out, followed by the actual card image. 

5. INTERPRETER SECOND PASS 

Printed on the first line of the JOLLZ output for identification of 
program operation. 

6. TEST DECK ID DOES NOT MATCH CONTROL CARD ID 

¥hen a mismatch of program identifications between these two cards 
occurs, this message is written. 

7. NO TEST ON TAPE CORRESPONDING TO CONTROL CARD ID 

If the test (JOVIAL-coded program) is on pre stored tape, and the SEARCH 
subroutine of JTCPZ cannot locate this program, this message is written. 

8. INTERPRETER FIRST PASS 

Printed on the first line of the JALLZ output for identification of 
program operation. 



FN-LO-200 

1 February i960 

Page Ik 

9, TEST TERMINATED BY ERROR IN POL 

If, during operation of JALLZ, an error is detected in the JOVIAL-coded 
program, control is returned to JTCPZ, and Sense Indicator Bit Twelve 
indicates an error . This message is then written out prior to termi- 
nation of the test. 

10. ASSEMBLE BABY G0MP00L 

Printed on the first line of the JABGZ output for identification of 
program operation. 

11. DATA SIMULATION PROGRAM 

Printed on the first line of the JSTRZ output for identification of 
program operation. 

12. TAPE DISPOSITION 

SAVE MASTER TAPE DRIVE Al 

PRINT OFF-LINE DRIVE A2 

PRINT OFF-LINE DRIVE Bl 

DISPOSE OF CI, Bl, D2 

This message is printed upon completion of an entire test run, and 
indicates to the computer operators the procedure to be followed in 
handling the system tapes. 

13. DATA PROCESSING PROGRAM 

Printed on the first line of the JDSYZ output for identification of 
program operation. 

1U. TEST COMPLETE 

Printed after the conclusion of operation of JDSYZ j this denotes the 
successful completion of system operation on one JOVIAL-coded program. 

1^. TEST CONTROL RUN COMPLETE 

Printed upon the completion of an entire test run. 

16. UNABLE TO READ IN ABOVE PROGRAM 

This message is generated when the program in question cannot be 
located on the tape by the SEARCH subroutine. 
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17. UNABLE TO LOCATE MASTER COMPOOL 

This message is generated when there is a mismatch of Compool 
identifications between the SEARCH subroutine parameter (obtained 
from the Test Control Card) and the Compool on tape. 

18. LOGICAL END-OF-TAPE 
TAPE UNIT UNASSIGNED 
NO READ MACRO 

THREE UNSUCCESSFUL TRIES 
ILLEGAL EOF 

TAPE NOT^ ASSIGNED ON WREOF 
CANNOT WRITE EOF ON DLO 

The above messages will be generated by JTCPZ whenever the input-output 
routines are rendered non- operative. The appropriate error message 
will appear under that program currently operating, thus localizing to 
some degree the source of error. 

1/~> rrrnnm /"i/-vn tit-it-* at /"*«■»-.»■» ,--»-,-.,-.._ -. __ 

7. uiioi ouwiROL CARjU MlbulMi 

Since a test cannot be initiated until a matching of program identi- 
fications occurs, this message denotes the source of error as opposed 
to an actual identification mismatch. 

20. ENDTST CARD MISSING 

Although this type of error will not affect the system operation, it 
nevertheless appears to denote the omission of the ENDTST card in the 
deck of control cards. 

21. NO BACK MACRO 

TTTW1AT TJinv fvnn>n«nvrniiT 
j-xjj_u_nj.n„u ij.n.UiY ur.muii.XUM 

One of these two messages is generated within the SEARCH subroutine 
whenever it cannot position the tape to the program identification 
record after having obtained a matching of program identifications. 

All output messages denoted above will appear both on- and off-line 
to facilitate tape handling by the computer operators, and to give 
a "penraaent" message on the DLO tape as an aid in future system 
operation. 
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A listing of the program symbolic 
deck will be issued as the first supplement 
to this document (FN-LO-200, S-l). 



Distribution: 

SDC (Lodi) 

Division Staff (l ea.) 
Programming Branch Staff (l ea. ) 
Program Production Group (l ea.) 
Program Design Group - M. Mineart (20) 
Program Requirements Group - F. Diaz (5) 
CUSS Project - J. I. Schwartz (10) 

SDC (Santa Monica) IEC 

J. D. Madden Standard Distribution (35) 

R. Bosak 
J. Matousek 

B. Morris s 

G. Dobbs (10) 
E. Gordon 

C. M. Lawson 
D« E. Henley 
G. Jacobs 



:cah 



